Launch My App 1.6

Welcome to LMA! This plugin is used to call other applications from eDonkey2000/overnet.

It has two main functions:

1) Calling a program when a file completes
2) Calling a program when the user click on the LMA menu

When a download completes, LMA will go through its list of programs and extensions to see
if there is an appropriate program to launch. If it finds one, it will call it with
the flags you specify, and the file as a command line parameter.

When you right click on the transfers view and select Plugins | Launch My App, it will
look up which program to launch depending on the extension, and will send the partial
files to it (with a flag if specified) to the program.

This means, only programs that are smart enough to handle the part files will work with
this plugin!


----Configuration----

To configure Launch My App, go to Options | Plugins. Click on Launch My App and click
on the configure button. You will be presented with a dialog box. You can enter
your list of applications here. 

To add a new program, click on Add.

To remove a program, select it and click Remove.

To change to order of the programs, select it and click move up or down (when an app
is going to be launched, it will look down the list in order until it finds a match,
so moving an app up will cause it to be launched if there are multiple apps that
have the same extension in their lists)

Once you clicked Add you will see a "..." on the first column. Click on this to see a drop
down box to choose the action you want to cause this application to be launched.

Then, click on the box next to it to launch the application chooser. Look for the program you
want to launch when the action takes place.

Then click on the next box to enter any flags that the program needs to launch these files
(some programs might need flags to accept command line parameters, or to know to do something
special with part files)

Finally, enter the extensions the application will accept. It should be in a comma seperated format
like this 

txt,nfo,doc,rtf

Options:

Run every matching app: This will run through all matching applications you have that have
the extension in their list. If you have this unchecked, it will stop after it finds the 
first one.

Echo actions in console: Will display text on the console when the plugin launches the
apps.

-----Some examples-----

Lets say I want to have all my text files launch in notepad when they finish.

Launch On Complete | c:\windows\notepad.exe | | nfo,txt,rtf,doc

Or I could use a previewer to preview my partial files (if it supports this operation)

Launch On Click | c:\program files\SuperPreviewerProgram.exe | -partials | wav,mp3,avi,mpg

Or, I could write a program to play a wav file when a movie is completed

Launch On Complete | C:\program files\playMySound.exe | | avi,mov,mpg,div

where playMySound actually ingores the command line and just playes a sound. Or even

Launch On Complete | C:\program files\playMySound.exe | completedFile.wav | avi,mov,mpg,div

where playMySound only reads the first command line parameter and playes it (completedFile.wav) and
ignores the rest (otherwise it would try and "play" the movie files, ruining your speakers ;) )

If you wanted the files to actually play when you're done downloading them, you could do

Launch On Complete | C:\program files\Winamp\winamp.exe | | wav,mp3,ogg

Or, you could virus scan your executables and naughty document files

Launch On Complete | c:\program files\virusscanner.exe | | exe,com,bat,doc,xls,mp3

------------------------

There are lots of possiblities, but it relies on the abilities of the programs you call, not
so much so with "Launch on complete", since it will usually do the right thing if it can handle
command line parameters, but "Launch on click" will only work if they understand how to decode
the part files! I'm sure someone will write a previewer that will work with this plugin (hint hint
programmers!)

anyway, hope it works for you.

If there are bugs, email them to me at

(c n o j i m a (at) o v e r n e t . c o m)

thanks


---- change log ------

1.6
Added support for new eDonkey2000/overnet temp filesystem (0.49)
Added option that makes blank extensions mean "every file"

1.5
Plugin would crash if you tried to configure when it wasn't really loaded.

1.4
First field would get cut off in config dlg

1.3
First public release
Versioning
Echo, running matching apps options
Bitfield stuff

1.1 - 1.2 
Beta releases

1.0
Alpha release